home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Development Platforms / Apple II / Essentials / GSBug / Read.Me < prev    next >
Encoding:
Text File  |  1992-07-01  |  6.2 KB  |  135 lines  |  [TEXT/pdos]
  1.  
  2.                 GSBug & Debugging Tools Update Release Notes
  3.  
  4.                                     1-Jul-92
  5.  
  6.  
  7. This folder contains the latest versions of GSBug & Debugging Tools.  These
  8. tools are useful with or without the APW or ORCA development environments.
  9. If you're using Merlin, Micol, TML, MPW IIGS, or any other development
  10. environment to write Apple IIGS software, then these tools (especially GSBug)
  11. will be VERY useful in finding bugs in the software you're developing.
  12.  
  13. These tools are a fully copyrighted work of Apple Computer, Inc and may NOT be
  14. redistributed.  All Rights Reserved.
  15.  
  16. Futher information on using GSBug itself can be found in the "GSBug.Tutorial"
  17. file in the "Docs" folder.  Details on how to use new GSBug features can be
  18. found in the "GSBug.Specs" file.  Those two files will explain a LOT of things
  19. to you.  The tutorial is especially useful if you do not have the manual (or
  20. you have the manual, but never bothered to read it).
  21.  
  22. The tutorial and specs files only teach you the basics--there is a LOT
  23. more that can be done with GSBug, but you'll need the manual to be able to
  24. tap into them.  The 140 page manual for GSBug & Debugging Tools contains
  25. details on how to use these tools.  Those of you without this manual can get
  26. one from Resource Central, as described in GSBug.Tutorial.
  27.  
  28. GSBug best supports debugging of 16-bit software.  Recent changes made to it
  29. provide minimal functionality for debugging 8-bit software. Please read the
  30. "GSBug.Specs" file for details.
  31.  
  32. ONLY the INIT version of GSBug is being provided.  The old application
  33. version is no longer supported.  Instead, we provide an easy way for you to
  34. install and remove the INIT version on the fly.
  35.  
  36.  
  37. Installing and removing GSBug on the fly
  38.  
  39. If you're using System 6, install IR 2.0.1 ("IR" stands for "Init Restarter").
  40. Then mark Debug.Init inactive (so it does not load at boot time).  Read the
  41. IR2.0.Read.Me file in the IR.2.0.1 folder to learn how to install and use IR.
  42.  
  43. With IR installed, double-click the Debug.Init icon from the Finder and GSBug
  44. installs instantly (you never leave the Finder).  IR works with CDAs, too,
  45. so you can use the same trick with the other debugging utilities included here.
  46.  
  47. (If you're using system software older than 6.0, you can use the old version
  48. of IR in the IR.pre.6.0 folder.  It's slower, since the Finder launches IR,
  49. which installs the file you opened, and then quits back to the Finder.)
  50.  
  51. You can remove the INIT version after booting by entering the debugger (the
  52. tutorial file tells you how) and typing "UNLOAD", then pressing RETURN.  This
  53. removes the debugger.  If your application crashed into the debugger and you
  54. unload the debugger, your application will still be crashed (but into the
  55. monitor now that GSBug is gone).  If your application is NOT crashed (that is,
  56. you entered the debugger by pressing the key sequence that drops you in
  57. safely), then unloading GSBug will resume operation of your application as
  58. though nothing happened (actually, plenty happened - GSBug was removed from
  59. memory and you can't drop into it any more because it's gone).
  60.  
  61.  
  62. Distribution of IR 2.0.1
  63.  
  64. You may redistribute the _entire_ IR 2.0.1 package, including documentation,
  65. source code and object files.  You may _not_ redistribute any parts of the
  66. package  alone unless you license this GSBug disk from Apple Computer's
  67. Software Licensing department.  Taken together, the IR 2.0.1 folder's contents
  68. are sample code and are redistributable.  Split apart, it's Apple software and
  69. like other Apple software must be licensed.
  70.  
  71. The other utilities on this disk must NOT be redistributed.
  72.  
  73.  
  74. Directions for installing the tools
  75.  
  76. GSBug & Debugging Tools installation:
  77.  
  78.    - copy the files in the "GSBug/System.Setup" folder to your boot disk's
  79.      System.Setup folder (full path "*/System/System.Setup").  This provides
  80.      you with the INIT version of GSBug the next time you boot your computer
  81.      from the disk you just installed onto.  It also provides you with the
  82.      templates for toolbox data structures (such as grafPorts, windows, menu
  83.      bars, etc).  Information on using the templates is in the "Templates.Info"
  84.      file.  General info on using templates of your own with GSBug is in the
  85.      GSBug Reference manual.
  86.  
  87.    - copy the desk accessories in the "GSBug/Desk.Accs" folder to your boot
  88.      disk's Desk.Accs folder (full path "*/System/Desk.Accs").  This provides
  89.      you with additional debugging tools such as Loader Dumper, Memory Mangler,
  90.      Scrambler, and Snooper.  You must reboot from the disk you just installed
  91.      onto in order for those desk accessories to show up.
  92.  
  93.    - copy the Exerciser application to where ever you normally install your
  94.      applications.  It doesn't really care what folder it lives in.  There is
  95.      a desk accessory version of the Exerciser, so you don't HAVE to use the
  96.      application version if you don't want to.
  97.  
  98.    - copy IR from the IR.2.0.1 folder to your boot disk's System.Setup folder
  99.      (full path "*/System/System.Setup").
  100.  
  101.  
  102. Double check your */System/System.Setup folder to be certain that you have
  103. ONLY one copy of the GSBug INIT file, called Debug.Init.  Get rid of any
  104. files named GSBug.Init or GSBug1.5b11.Init or whatever.  Having two copies
  105. of GSBug causes nasty things to happen since both copies would be trying
  106. to do the same thing.  One GSBug is all you need.
  107.  
  108.  
  109.  
  110.       DISCLAIMER OF WARRANTY
  111.  
  112.       THE SOFTWARE IS PROVIDED "AS IS" WITHOUT
  113.       WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
  114.       WITH RESPECT TO ITS MERCHANTABILITY OR ITS FITNESS
  115.       FOR ANY PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO
  116.       THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
  117.       YOU.  SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND
  118.       NOT APPLE OR AN APPLE AUTHORIZED REPRESENTATIVE)
  119.       ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING,
  120.       REPAIR OR CORRECTION.
  121.  
  122.       Apple does not warrant that the functions
  123.       contained in the Software will meet your requirements
  124.       or that the operation of the Software will be
  125.       uninterrupted or error free or that defects in the
  126.       Software will be corrected.
  127.  
  128.       SOME STATES DO NOT ALLOW THE EXCLUSION
  129.       OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY
  130.       NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC
  131.       LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS
  132.       WHICH VARY FROM STATE TO STATE.
  133.  
  134.  
  135.